home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmStringTableParseStringArray.z / XmStringTableParseStringArray
Encoding:
Text File  |  2002-10-03  |  6.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrrUUUUaaaaNNNNyyyyIIII((((XXXX3333XXXXSSSS))))yyyyXXXXssssmmmmttttSSSSeeeettttmmmmrrrriiiiVVVVnnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrraaaayyyy((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrraaaayyyy - A convenience function that
  10.           converts an array of strings to a compound string table
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrraaaayyyy(
  15.           XXXXttttPPPPooooiiiinnnntttteeeerrrr ****ssssttttrrrriiiinnnnggggssss,
  16.           CCCCaaaarrrrddddiiiinnnnaaaallll ccccoooouuuunnnntttt,
  17.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ttttaaaagggg,
  18.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee ttttyyyyppppeeee,
  19.           XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee ppppaaaarrrrsssseeee,
  20.           CCCCaaaarrrrddddiiiinnnnaaaallll ppppaaaarrrrsssseeee____ccccoooouuuunnnntttt,
  21.           XXXXttttPPPPooooiiiinnnntttteeeerrrr ccccaaaallllllll____ddddaaaattttaaaa);
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents Motif 2.1.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrraaaayyyy takes an array of strings,
  28.           allocates an XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee with an equal number of slots,
  29.           calls XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt on each string in _s_t_r_i_n_g_s, and
  30.           inserts the resulting XXXXmmmmSSSSttttrrrriiiinnnngggg in the corresponding slot in
  31.           the XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee.
  32.  
  33.           _s_t_r_i_n_g_s   Specifies an array of strings of characters as
  34.                     determined by _t_y_p_e.
  35.  
  36.           _c_o_u_n_t     Specifies the number of strings in _s_t_r_i_n_g_s.
  37.  
  38.           _t_a_g       Specifies the tag to be used in creating the
  39.                     result. The type of tag created (charset or
  40.                     locale) depends on the type of the text and the
  41.                     value given. If the value specified is NULL, and
  42.                     _t_y_p_eindicates that a charset tag should be
  43.                     created, then the tag will have the value of
  44.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG.  If _t_y_p_eindicates a locale
  45.                     tag, then the tag will have the value of
  46.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG.
  47.  
  48.           _t_y_p_e      Specifies the type of text to be passed in and the
  49.                     type of tag. If the type is either
  50.                     XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT or XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, a locale tag
  51.                     should be created. If the type is XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT,
  52.                     a charset tag will be created.
  53.  
  54.           _p_a_r_s_e     Specifies the parse table to be used.
  55.  
  56.           _p_a_r_s_e__c_o_u_n_t
  57.                     Specifies the number of entries in the parse
  58.                     table.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrrUUUUaaaaNNNNyyyyIIII((((XXXX3333XXXXSSSS))))yyyyXXXXssssmmmmttttSSSSeeeettttmmmmrrrriiiiVVVVnnnnggggTTTTaaaabbbblllleeeePPPPaaaarrrrsssseeeeSSSSttttrrrriiiinnnnggggAAAArrrrrrrraaaayyyy((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _c_a_l_l__d_a_t_a Specifies data to be passed to the parse
  75.                     procedures.
  76.  
  77.      RRRREEEETTTTUUUURRRRNNNN
  78.           Returns a new XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee.  The function allocates space
  79.           to hold the XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee.  When the application no longer
  80.           needs the returned XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee, the application should
  81.           call XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee_c_o_u_n_t times (that is, one time for each
  82.           returned compound string) and then call XXXXttttFFFFrrrreeeeeeee to deallocate
  83.           the XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee itself.
  84.  
  85.      RRRREEEELLLLAAAATTTTEEEEDDDD
  86.           XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee(3) and XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt(3).
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.